home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / nosvw137.zip / SMTP < prev    next >
Text File  |  1991-09-18  |  11KB  |  267 lines
  1. ====                                                NOSview [137]
  2. smtp
  3. ====
  4.  
  5.  
  6. The 'smtp' commands are used for controlling mail forwarding
  7. using the Simple Mail Transfer Protocol (SMTP).
  8.  
  9. _________________________________________________________________
  10. smtp batch [on|off]                                  Default: off
  11. _________________________________________________________________
  12. Display or set the smtp batch flag.
  13.  
  14. When set to 'on', messages in the outgoing mail queue are sent as
  15. a batch, whereby many of the SMTP commands are sent in one fell
  16. swoop before waiting for responses.  (Unfortunately this breaks
  17. many brain-damaged SMTP servers, and so may not be usable in
  18. practice).
  19.  
  20. >> Example:  smtp batch on
  21.  
  22.  
  23. _________________________________________________________________
  24. smtp gateway [<host>]
  25. _________________________________________________________________
  26. Displays or sets the host to be used as a "smart" mail relay
  27. station.
  28.  
  29. The gateway is used when you are sending mail to any station
  30. which does not exist in DOMAIN.TXT or in the domain cache.
  31.  
  32. >>  Example:  smtp gateway ns9gwa
  33.  
  34.  
  35. _________________________________________________________________
  36. smtp kick
  37. _________________________________________________________________
  38. The 'smtp kick' command reviews the outgoing mail queue in
  39. directory N:\SPOOL\MQUEUE, and attempts to deliver any pending
  40. mail.
  41.  
  42. Normally the queue is reviewed automatically at regular intervals
  43. (specified by the 'smtp timer' command), but occasionally you may
  44. want to "kick" the mail system manually to force SMTP to send the
  45. mail.
  46.  
  47.  
  48. _________________________________________________________________
  49. smtp kill <job_number>
  50. _________________________________________________________________
  51. Every outgoing message is allocated a job number (which you can
  52. discover from the 'smtp list' command; see below).  You can then
  53. kill a particular job with the 'smtp kill' command.
  54.  
  55. >> Example:  smtp kill 6
  56.  
  57.  
  58. _________________________________________________________________
  59. smtp list
  60. _________________________________________________________________
  61. List the messages in the outgoing mail queue.
  62.  
  63. >> Example of 'smtp list' output display:
  64. ...................................................
  65. : S  Job    Size Date  Time  Host    From         :
  66. : L    3     244 09/13 07:13 g9liz   helen@ns9bob :
  67. :   bill@g9liz                                    :
  68. : L    6     243 09/13 07:14 ns9ken  bob@ns9bob   :
  69. :   fred%ax9bbs@ns9ken                            :
  70. :.................................................:
  71.  
  72. The 'L' entry in the 'S' status column indicates that the message
  73. entry is locked by SMTP; in other words, SMTP is attempting to
  74. send the message.
  75.  
  76.  
  77. _________________________________________________________________
  78. smtp maxclients [<count>]                             Default: 10
  79. _________________________________________________________________
  80. Displays or sets the maximum number of simultaneous outgoing SMTP
  81. sessions that will be allowed.  Reduce the number if network
  82. congestion is a problem.
  83.  
  84. >> Example:  smtp maxclients 10
  85.  
  86.  
  87. _________________________________________________________________
  88. smtp mode [queue|route]                            Default: route
  89. _________________________________________________________________
  90. By default, the SMTP mode is 'route', which means that incoming
  91. mail is directed to the mail queue N:\SPOOL\MAIL.  You can then
  92. read the mail there with the 'bbs' command, or by using an
  93. external mailer such as BM or ELM.
  94.  
  95. If the mode is set to 'queue', incoming mail is directed instead
  96. to the special mail forwarding queue N:\SPOOL\RQUEUE.  The mail
  97. is stored in .WRK and .TXT files in the same format as the normal
  98. outgoing mail files in N:\SPOOL\MQUEUE.
  99.  
  100. A special forwarding program (not supplied with NOS) is then
  101. required to send the mail in N:\SPOOL\RQUEUE onwards to its
  102. destination.
  103.  
  104. This mechanism provides added flexibility to NOS for handling
  105. mail in different ways.
  106.  
  107. >> Example:  smtp mode route
  108.  
  109.  
  110. _________________________________________________________________
  111. smtp quiet [on|off]                                  Default: off
  112. _________________________________________________________________
  113. Display or set the SMTP quiet flag.
  114.  
  115. This flag determines whether the bell sounds when the system
  116. announces that incoming mail has arrived.  When quiet is set to
  117. 'off' you hear the bell.
  118.  
  119. >> Example:  smtp quiet on
  120.  
  121. [Some versions of NOS inhibit the incoming mail message as well
  122. as the bell when quiet is 'on'.  This has the advantage that the
  123. message does not overwrite the screen if you happen to be shelled
  124. out of NOS when a message arrives].
  125.  
  126.  
  127. _________________________________________________________________
  128. smtp timer [<seconds>]                                 Default: 0
  129. _________________________________________________________________
  130. Display or set the interval between automatic scans of the
  131. outbound mail queue.
  132.  
  133. Setting a value of zero disables queue scanning altogether.
  134.  
  135. >>  Example:  smtp timer 600
  136.  
  137.  
  138. _________________________________________________________________
  139. smtp trace [<value>]                                   Default: 0
  140. _________________________________________________________________
  141. Display or set the trace flag in the SMTP client, allowing you to
  142. watch SMTP's conversations as it delivers mail.
  143.  
  144. Setting the flag to any non-zero value enables tracing.  A value
  145. of 9 gives a full trace.
  146.  
  147. >> Example:  smtp trace 9
  148.  
  149. For example, when sending a message, the output of the smtp trace
  150. is of the form (trace messages shown outdented):
  151. ................................................................
  152. :    Current msg#0:?,A,B,C,D,E,F,G,H,I,J,K,L,N,R,S,T,U,V,W,Z > :
  153. :    sp ken@ns9ken                                             :
  154. :    Subject: Hi Ken                                           :
  155. :    Enter message.  Terminate with /EX or ^Z in first column  :
  156. :    How are you today?                                        :
  157. :    ^Z                                                        :
  158. : smtp daemon entered, target = 0.0.0.0                        :
  159. : MX lookup for = ns9ken                                       :
  160. : Mailroute returned = ns9ken                                  :
  161. : queue job 3 From: bob@ns9bob To: ken@ns9ken                  :
  162. : Trying Connection to ns9ken                                  :
  163. : SMTP client Trying...                                        :
  164. : Connected                                                    :
  165. : smtp recv: 220 ns9ken SMTP ready                             :
  166. : smtp sent: HELO ns9bob                                       :
  167. : smtp recv: 250 ns9ken, Share and Enjoy!                      :
  168. : smtp sent: MAIL FROM:<bob@ns9bob>                            :
  169. : smtp recv: 250 Ok                                            :
  170. : smtp sent: RCPT TO:<ken@ns9ken>                              :
  171. : smtp recv: 250 Ok                                            :
  172. : smtp sent: DATA                                              :
  173. : smtp recv: 354 Enter mail, end with .                        :
  174. : smtp sent: .                                                 :
  175. : smtp recv: 250 Sent                                          :
  176. : smtp sent: QUIT                                              :
  177. :..............................................................:
  178.  
  179.  
  180. _________________________________________________________________
  181. smtp usemx [on|off]                                  Default: off
  182. smtp mxlookup [on|off]                               Default: off
  183. _________________________________________________________________
  184. Display or set a flag enabling or disabling MX record lookups.
  185. This can be enabled if a domain server is available in the near
  186. vicinity.  It should be disabled (default) if no domain server is
  187. in reach to satisfy the MX query.
  188.  
  189. See the 'domain' command for an explanation of MX records.
  190.  
  191. >> Examples: smtp usemx on
  192.              smtp mxlookup on
  193.  
  194. When usemx is set to 'off', SMTP will use the current smtp
  195. gateway setting if it cannot find the recipient host in the
  196. DOMAIN.TXT (see the 'smtp gateway' command above).
  197.  
  198. For example, if the smtp gateway is ns9gwa and you send a message
  199. to zz9abc (which is not in DOMAIN.TXT or in the domain cache),
  200. the trace will show:
  201. ...............................
  202. : MX lookup for = zz9abc      :
  203. : Mailroute returned = ns9gwa :
  204. :.............................:
  205.  
  206. When usemx is set to 'on', SMTP will look for an MX record for
  207. the message recipient.  If an MX record exists, SMTP will route
  208. the message to the gateway specified in the record.
  209.  
  210. For example, if "ns9zzz.ampr.org. IN MX 0 ns9mhb.ampr.org."
  211. exists in DOMAIN.TXT, the trace will show the following when
  212. sending a message to ns9zzz:
  213. ...............................
  214. : MX lookup for = ns9zzz      :
  215. : MX lookup returned = ns9mhb :
  216. : Mailroute returned = ns9mhb :
  217. :.............................:
  218.  
  219. Note that MX record handling is very limited in NOS.  If an
  220. answer from a domain name server comes in it is taken to be the
  221. destination.
  222.  
  223.  
  224. _________________________________________________________________
  225. telnet <host> 25
  226. _________________________________________________________________
  227. When using the 'telnet' command with well-known port 25, you can
  228. communicate direct with the SMTP server.  This is useful if you
  229. want to interrogate the ALIAS file on a remote host, to find out
  230. aliases and mail distribution lists.
  231.  
  232. For example, here is ns9ken's ALIAS file:
  233. -----------------------------------------------------------------
  234. bob ns9bob@ns9zzz
  235. thegang ns9ccc@ns9ddd ns9eee@ns9fff ns9ggg@ns9hhh
  236. helen NS9HEL%AX9BBS@ns9zzz
  237. -----------------------------------------------------------------
  238.  
  239. You can then interrogate this file remotely with the command
  240. 'telnet ns9ken 25'.  Once connected, you can give the SMTP 'help'
  241. command to discover what commands are supported.
  242.  
  243. One of these commands is 'expn', which you can then use to expand
  244. alias entries.
  245.  
  246. When you are done, give the 'quit' command.
  247.  
  248.  
  249. >> Example of the screen output (with user commands indented):
  250. ....................................................
  251. : Resolving ns9ken... Trying ns9ken:smtp...        :
  252. : Telnet session 2 connected to ns9ken             :
  253. : 220 ns9ken SMTP ready                            :
  254. :   help                                           :
  255. : 214-Commands                                     :
  256. : 214-HELO NOOP MAIL QUIT RCPT HELP DATA RSET EXPN :
  257. : 214 End                                          :
  258. :   expn thegang                                   :
  259. : 250-ns9ggg@ns9hhh                                :
  260. : 250-ns9eee@ns9fff                                :
  261. : 250-ns9ccc@ns9ddd                                :
  262. :   quit                                           :
  263. : 221 Closing                                      :
  264. : Telnet session 2 closed: EOF                     :
  265. : Hit enter to continue                            :
  266. :..................................................:
  267.